home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / apps / database / tcos.arc / TCOS.DOC < prev    next >
Text File  |  1989-07-08  |  14KB  |  330 lines
  1.  
  2.  
  3.                                     TCOS v1.2
  4.                                     ---------
  5.                          
  6.                            (c) Perfect Evolution 1989
  7.  
  8.                             By Matthew P. Aubury (15)
  9.                     
  10.  
  11.                                User Documentation
  12.                                ------------------
  13.  
  14.                               1    Introduction
  15.                              1.1   Getting Started
  16.  
  17.                               2    Window Handling    
  18.  
  19.                               3    Desk Menu
  20.  
  21.                               4    System Menu
  22.                              4.1     Loading/Saving
  23.                              4.2     Join System
  24.                              4.3     New System
  25.                              4.4     System Status
  26.                              4.5     System Tree
  27.  
  28.                               5    Data Menu
  29.                              5.1     Editing
  30.                              5.2     Reformat Text
  31.                              5.3     Erase Text
  32.                              5.4     Import Graphics
  33.                              5.5     Assign Image
  34.  
  35.                               6    Card Menu
  36.                              6.1     Goto Card
  37.                              6.2     Rename Card
  38.                              6.3     Copy Card
  39.                              6.4     Add Button
  40.                              6.5     Replace Button
  41.                              6.6     Delete Button
  42.  
  43.                               7    Appendix
  44.  
  45.  
  46.  
  47.           1.   Introduction
  48.           -----------------             
  49.  
  50.                'TCOS'  is an information storage system which will  run 
  51.           on  any Atari ST in either medium or high resolution.  It  is 
  52.           designed  to allow you to structure information in a  logical 
  53.           way which allows you to access data quickly and efficiently.
  54.                Data is arranged in a series of 'cards',  which  contain 
  55.           either text or graphics. Areas of the cards are designated as 
  56.           'buttons',  which,  when  clicked on with the mouse  pointer, 
  57.           bring  up further cards.  In this way,  a branching  tree  of 
  58.           cards  is  formed,   which  allows  the  information  to   be 
  59.           structured in a sensible way.
  60.                This  technique lends itself to many  uses:  referencing 
  61.           information,  diagnostic systems,  expert systems,  and  even 
  62.           teaching programs.
  63.  
  64.  
  65.           1.1  Getting Started
  66.           --------------------          
  67.           
  68.                To  start  the  program,   double  click  on  the   file 
  69.           'TCOS.PRG',  which  will load and display a GEM menu  and  an 
  70.           'UNTITLED' window.  The menu options and window handling  are 
  71.           discussed later,  but for an example,  move the mouse pointer 
  72.           up  to the 'SYSTEM' heading,  and click on the 'LOAD  SYSTEM' 
  73.           option.  When the file selection box appears, select the file 
  74.           'DEMO.SYS'. A new card will appear, with some information on. 
  75.           Click within any one of the three red boxes and another  card 
  76.           will appear, and so on. To go back a card, click on the close 
  77.           window character at the top left-hand corner of each card.
  78.  
  79.  
  80.           2.   Window Handling
  81.           --------------------          
  82.           
  83.            a)  By clicking on the close window icon in the top left  of 
  84.           each card, you can go back to the parent of each card, unless 
  85.           you are on the root card.
  86.  
  87.            b)   By clicking and holding the icon at the bottom right of 
  88.           the card,  you can resize the window. If there is any text in 
  89.           the window, you are given the choice to reformat the text, or 
  90.           not.  If you don't,  each of the lines will be cut off at the 
  91.           new  size  (which  can be useful if you are  dealing  with  a 
  92.           table).
  93.  
  94.             c)  If there are any buttons on the window,  they  will  be 
  95.           displayed as lines (red if you are in medium resolution).  By 
  96.           clicking  within any one of these you will bring up the  next 
  97.           card.
  98.  
  99.  
  100.           3.   Desk Menu
  101.           --------------          
  102.           
  103.                Under the desk menu is the choice 'Information on TCOS', 
  104.           which displays the copyright message, and any desk accesories 
  105.           you have installed. All these function as normal.
  106.  
  107.  
  108.           4.   System Menu
  109.           ----------------     
  110.           
  111.                The   'System'  menu  deals  with   general   operations 
  112.           regarding the the structure of the data.
  113.  
  114.  
  115.           4.1  Loading and Saving
  116.           -----------------------          
  117.           
  118.             a)  Clicking on the 'Load System' option brings up  a  file 
  119.           selection box.  Choosing a system will load it,  erasing  the 
  120.           system currently in memory.
  121.  
  122.              b)   Clicking on the 'Save System' option will  store  the 
  123.           current  system on disk.  The name of the root  (first)  card 
  124.           will  be the same as the filename,  so changing the  filename 
  125.           will change the name of the first card, and vice versa.
  126.  
  127.  
  128.           4.2  Join System
  129.           ----------------          
  130.           
  131.                This option allows you to build much larger systems than 
  132.           the usual, by dividing them over a number of disk files. This 
  133.           is advisable if you intend to write very large  systems,  for 
  134.           two reasons:  First,  if you write many cards you may run out 
  135.           of  memory,  and secondly,  as each system is loaded  in  one 
  136.           piece,  a  very  large system would take too  long  to  load, 
  137.           whereas it is easier just to load the piece you require.  You 
  138.           may  have a base system,  with just a few  options,  each  of 
  139.           which loaded a new system.
  140.                When  using the option,  you are given a file  selection 
  141.           box,  from which you choose the system which will be  joined. 
  142.           The program then deletes the current card,  having designated 
  143.           it as a 'join' card and returns you to the parent card. Thus, 
  144.           whenever  you bring up the card,  the new system selected  is 
  145.           loaded into memory.  Be warned, however, that loading the new 
  146.           system  deletes the current one,  so save any changes  before 
  147.           testing the option.
  148.  
  149.           
  150.           4.3  New System
  151.           ---------------
  152.           
  153.                The 'New System' option allows you to completely  delete 
  154.           all  cards  and  information  in  memory.  An  alert  box  is 
  155.           displayed to prevent you erasing the system accidentally.
  156.  
  157.           
  158.           4.4  System Status
  159.           ------------------          
  160.           
  161.                Clicking  on the 'System Status' option will bring up  a 
  162.           small  dialog box,  detailing the amount of free  memory,  of 
  163.           free and used cards and free disk space.
  164.  
  165.  
  166.           4.5  System Tree
  167.           ----------------          
  168.           
  169.                The  'System Tree' is a useful feature allowing  you  to 
  170.           see the structure of the system.  Clicking on it draws a tree 
  171.           of lines,  labelled at each intersection with the name of the 
  172.           each  card.  Using this you can trace the root to each  card, 
  173.           and see how many cards are dependant on any given card.
  174.  
  175.  
  176.           5.   Data Menu
  177.           --------------          
  178.           
  179.                The 'Data' menu deals with the contents of each card, be 
  180.           they text or graphics.
  181.  
  182.  
  183.           5.1  Edit Text
  184.           --------------          
  185.           
  186.                Once  selected,  the edit text option allows you to  add 
  187.           and  delete text,  as with any other text editor  (though  it 
  188.           lacks  many  of the refinements of a word  processor,  it  is 
  189.           quite adequate.) The keys which are operational,  apart  from 
  190.